home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / C / Games / Xconq 7.1.0 / src / xconq-7.1.0 / mac / README.mac < prev    next >
Encoding:
Text File  |  1996-07-07  |  3.8 KB  |  248 lines  |  [TEXT/R*ch]
  1. This is the Mac source directory for Xconq.
  2.  
  3. The instructions here are for building from source.  It is assumed
  4. that you have already either transferred the sources to a Mac or made
  5. a shared volume visible to one, and that you have moved and unpacked
  6. certain binary files; read and follow the instructions in
  7. "DO_FIRST.mac" in order to do this.
  8.  
  9. SYSTEM REQUIREMENTS
  10.  
  11. You will need a development environment.  Xconq is known to build
  12. under Think C 5 or 6, Symantec C 7, MPW 3.3 or 3.4, and CW 6 or 7.
  13. This is just for 68K systems; native PowerMac Xconq is still being
  14. developed.
  15.  
  16. You will need 8MB of RAM.
  17.  
  18. BUILDING
  19.  
  20. For Think C, just select "Build Application" from the menu.
  21.  
  22. For CodeWarrior, select "Make" from the menu.
  23.  
  24. For MPW, run the script "mpw-configure", then build "Xconq".
  25.  
  26. INSTALLING
  27.  
  28. No installation process is necessary.
  29.  
  30. If you want to move the executable elsewhere, you must also bring
  31. along "lib" and "lib-mac", and put them in the same folder as the
  32. application.
  33.  
  34. To make documentation in HTML format, use the Perl script texi2html
  35. in the "doc" directory.
  36.  
  37. ROAD MAP
  38.  
  39. Other Programs:
  40.  
  41. IMFApp is a utility for examining and converting the image families
  42. used by Xconq.
  43.  
  44. Skelconq is a game testing and compilation application that uses
  45. console I/O only.
  46.  
  47. Cconq is the curses version of Xconq.  Believe it or not, you can
  48. build and run the curses version using the "libcurses" library,
  49. and it works just fine.  (Hey, it's convenient for testing.  If
  50. you promise not to gag, I might tell you about how I check out X11
  51. code on my Mac...)
  52.  
  53. Files and Folders:
  54.  
  55. Generic sources are in "kernel", Mac-specific code in "mac".  Xconq
  56. uses all files in "mac" and "kernel" except for "skelconq.c",
  57. "cmdline.c", "compile.c", and OS-specific files, while Skelconq uses
  58. everything in "kernel" except OS-specific files and nothing in "mac".
  59.  
  60. Generic test cases and (Unix-based) test machinery are in "test".
  61.  
  62. Documentation in TeX (texinfo) is in "doc".  It should be possible to
  63. format the documents using OzTeX, but I haven't tried it myself.
  64.  
  65. Game translation tools and suchlike are in "misc".  The Perl scripts
  66. will run under MacPerl.
  67.  
  68. Sources to the other Xconq interfaces, if present, are in folders like
  69. "curses", "x11", and so forth.  Unix configuration info is in
  70. "config*" files and the "config" directory.
  71.  
  72. Note that "kernel", "lib", "test", "doc", and "misc" are identical on
  73. all systems, so don't put anything in them (such as binary files) that
  74. can't be included everywhere.  Since "mac" is a source directory, it
  75. should not have binary or resource files either, not even in binhexed
  76. form (they mess up diffs and patches). Use "lib-mac", "doc-mac", or
  77. "mac-only" for Mac-only files.
  78.  
  79. THINK C PROJECT
  80.  
  81. This describes how to rebuild the Think C project from scratch.
  82.  
  83. Files and Segments:
  84.  
  85. mac.c
  86. macconq.c
  87.  
  88. macdraw.c
  89.  
  90. macmap.c
  91.  
  92. macimf.c
  93. macmap2.c
  94.  
  95. maccmd.c
  96. macmenus.c
  97.  
  98. macwins.c
  99.  
  100. machelp.c
  101. maclist.c
  102.  
  103. macinit.c
  104.  
  105. macdesign.c
  106.  
  107. imf.c
  108. ui.c
  109.  
  110. run.c
  111.  
  112. ai.c
  113. mplayer.c
  114.  
  115. actions.c
  116.  
  117. combat.c
  118.  
  119. plan.c
  120. task.c
  121.  
  122. init.c
  123.  
  124. mkrivers.c
  125. mkroads.c
  126. mkterr.c
  127. mkunits.c
  128.  
  129. world.c
  130.  
  131. side.c
  132.  
  133. unit.c
  134.  
  135. history.c
  136. lisp.c
  137. mknames.c
  138. score.c
  139. util.c
  140.  
  141. help.c
  142. nlang.c
  143.  
  144. module.c
  145.  
  146. read.c
  147.  
  148. write.c
  149.  
  150. ps.c
  151.  
  152. tables.c
  153.  
  154. generic.c
  155. types.c
  156.  
  157. MacTraps
  158. MacTraps2
  159.  
  160. ANSI-32
  161.  
  162. Prefix:
  163.  
  164. #include <MacHeaders>
  165.  
  166. #define MAC
  167.  
  168. Think C Options:
  169.  
  170. strict prototype enforcement, require prototypes
  171. set 4-byte ints
  172. enums are always ints
  173.  
  174. CODEWARRIOR PROJECT
  175.  
  176. This describes how to rebuild the CodeWarrior project from scratch.
  177.  
  178. mac.c
  179. macconq.c
  180.  
  181. macdraw.c
  182.  
  183. macmap.c
  184.  
  185. macimf.c
  186. macmap2.c
  187.  
  188. maccmd.c
  189. macmenus.c
  190.  
  191. macwins.c
  192.  
  193. machelp.c
  194. maclist.c
  195.  
  196. macinit.c
  197.  
  198. macdesign.c
  199.  
  200. imf.c
  201. ui.c
  202.  
  203. run.c
  204.  
  205. ai.c
  206. mplayer.c
  207.  
  208. actions.c
  209.  
  210. combat.c
  211.  
  212. plan.c
  213. task.c
  214.  
  215. init.c
  216.  
  217. mkrivers.c
  218. mkroads.c
  219. mkterr.c
  220. mkunits.c
  221.  
  222. world.c
  223.  
  224. side.c
  225.  
  226. unit.c
  227.  
  228. history.c
  229. lisp.c
  230. mknames.c
  231. score.c
  232. util.c
  233.  
  234. help.c
  235. nlang.c
  236.  
  237. module.c
  238. read.c
  239.  
  240. write.c
  241.  
  242. ps.c
  243.  
  244. tables.c
  245.  
  246. generic.c
  247. types.c
  248.